home *** CD-ROM | disk | FTP | other *** search
/ PC World 2004 February / PCWorld_2004-02_cd.bin / software / vyzkuste / keys / Active-Keys-2.02.exe / {app} / WA2Mgr / readme_wa2mgr.txt < prev    next >
Encoding:
Text File  |  2003-08-09  |  6.5 KB  |  136 lines

  1. Winamp 2x Plugin Manager for Winamp 3
  2.  
  3. Copyright 2001 - 2002 Nicholas Schweitzer
  4. http://members.telocity.com/~schweitn/wa3/wa2mgr
  5. schweitn@telocity.com
  6.  
  7. Table of Contents
  8. -----------------
  9.  
  10. + Overview
  11.   - Features
  12.   - Supported Plugin Types
  13.   - How to Use
  14. + Known Issues
  15. + Reporting Bugs 
  16. + Version History
  17.  
  18. Overview
  19. --------
  20.  
  21. This component is designed to provide backwards compatibility to Winamp 3 (Wasabi) for Winamp 2.x plugins.
  22.  
  23. Featues:
  24.  
  25.    - Lists Winamp 2x Plugins Found 
  26.    - Allows Configuration of Loaded Plugins 
  27.    - Allows External Programs to Control Winamp 3 as if it were Winamp 2 
  28.    - Should Allow Any Language That Worked with Winamp 2x to Work with Winamp 3x 
  29.    - Allows You to Add Search Paths for the Plugins
  30.    - Allows Selective Loading of General Plugins
  31.  
  32. Supported Plugin Types:
  33.  
  34.    - General Plugins (gen*.dll) 
  35.    - DSP Plugins (dsp*.dll) 
  36.    - External Program Control 
  37.  
  38. How to Use:
  39.  
  40.    The first time your run Winamp 3 with this plugin installed, it will automatically search for plugins located in the Winamp3 Plugin folder, and the Winamp 2 Plugin folder (if Winamp 2 is installed) and loads them.
  41.  
  42.    Configuring plugins, and choosing the DSP plugin you would like is done just like it was in Winamp 2.  You will find the listing of available plugins in the Preferences window, under Winamp 2x Plugins.  They are listed in the DSP Plugins tab.
  43.  
  44.    General Plugins are NOT loaded by default.  This is in case you have a plugin that for some reason doesn't work with Winamp 3.  In order to activate a plugin, select it in the list, and click Load.  The list is found in the Preferences window, under Winamp 2x Plugins on the General Plugins tab. The plugin manager will remember which plugins were loaded so you don't have to do this every time you start Winamp 3.
  45.  
  46.    If a Winamp2 Plugin does not show up in the list, that means its either an Input, Output or Vis plugin.  Input plugins are supported by a component by Peter (www.blorp.com/~peter).  Output plugins are not supported by anyone.  Vis plugins were supported in earlier betas of Winamp3, and I'm told support for them will come back at some time.  Be patient.
  47.  
  48. Known Issues
  49. ------------
  50.  
  51.    - All Commands Not Yet Fully Supported
  52.    - No Messages are Sent back to the WA2 Plugin when things happen.
  53.    - That means that NOT ALL PLUGINS WILL WORK COMPLETELY!  I DO NOT support individual plugins my request.  If a plugin you have doesn't work properly, you'll have to wait until I implement more of the old API to see if it will work.
  54.    - Shoutcast DSP window works correctly the first time you load it.  However, if you deselect it, and then select it again, the window won't refresh properly.  The only current workaround is to restart Winamp3.
  55.  
  56. Reporting Bugs
  57. --------------
  58.  
  59. This component is written in my spare time, so don't expect immediate response to bugs that may come up. However, should you actually find a real bug, and wish to report it to me... here is the procedure for doing it: 
  60.  
  61.    1. Verify you have the latest plugin version 
  62.    2. Verify you have the latest supported version of Winamp 3 
  63.    3. Verify that the command not working properly is listed with an x in the Command Completion Matrix 
  64.    4. Verify that it is not a Known Issue 
  65.    5. Send an email to schweitn@telocity.com. It should Include the following:
  66.     - WA2Mgr.wac version 
  67.     - WA2 Plugin you had problems with 
  68.     - Expected behavior that you had with WA2 
  69.     - Behavior you experienced with WA3 
  70.  
  71.    ** BE AS SPECIFIC AS YOU CAN! Vague Reports will not be answered.  I WILL NOT ANSWER Mails that sound anything remotely like: This component sucks or This componenet doesn't work right (without details) or Bugs that are about Known Issues or As of Yet Unsupported Commands, etc. 
  72.  
  73. Version History
  74. ---------------
  75.  
  76. Version 1.1 - 8/30/2002
  77.  
  78.    - Fixed Bug: ** Winamp Crashes on Exit
  79.    - Fixed Bug: ** Winamp Crashes on Startup
  80.    - Fixed Bug: ** Winamp Crashes when focus moves away
  81.    - Fixed Bug: GET_OUTPUT_TIME was returning ms instead of sec
  82.    - Fixed Bug: Not all Plugin Windows Displayed/Refreshed Properly.  This is fixed for many but not all plugins.
  83.    - Added Uninstaller
  84.    ** I was never able to reproduce these bugs.  I believe I have taken action to correct them.  However, since I was never able to reproduce them in the first place, I don't know if they are full fixed.
  85.  
  86. Version 1.0 - 8/8/2002
  87.  
  88.    - Updated to Run with 3.0 Release
  89.    - Fixed Bug: GPF When Playing CD's
  90.    - Fixed Bug: Error When Playing Video and DSP Module Enabled
  91.    - Fixed Bug: Shoutcast DSP Module Crashes Winamp
  92.    - Added Ability to Only Load Desired General Plugins
  93.    - Several UI Improvements
  94.    - Moved window into Preferences and removed from thinger and components list.
  95.    - Added Support For More Commands: IPC_SETPANNING, IPC_GETLISTLENGTH, IPC_GETPLAYLISTFILE, IPC_GETLISTPOS, IPC_CHANGECURRENTFILE, WINAMP_BUTTON1_CTRL, WINAMP_BUTTON5_CTRL, IPC_PLAYFILE, IPC_GET_SHUFFLE, IPC_GET_REPEAT, IPC_SET_SHUFFLE, IPC_SET_REPEAT, WINAMP_OPTIONS_AOT, WINAMP_HELP_ABOUT
  96.  
  97. Version 0.6 - 2/14/2002
  98.  
  99.    - Updated to Run With Beta 3 Days
  100.    - Included New Thinger Icon
  101.    - Added Support For More Commands: WINAMP_OPTIONS_PREFS
  102.    - Stubbed Out Any Unimplemented Commands to Help Prevent GPF's on Plugin Manager
  103.    - Fixed Bug: Memory Leak Caused User Breakpoint In Debug Mode
  104.    - Packaged Up Wac With NSIS
  105.    - Several UI Improvements
  106.    - Settings Tab Now Fully Functional
  107.    - Last Active DSP Module Now Remembered
  108.  
  109. Version 0.5 - 11/30/2001
  110.  
  111.    - Fixed Bug: Sound Quality Very Bad With Certain DSP Plugins 
  112.    - Fixed Bug: Winamp Crashes After Certain Number of Songs. 
  113.    - Fixed Bug: GPF On Close 
  114.  
  115. Version 0.4 - 11/29/2001
  116.  
  117.    - Updated to Run With Beta 2 Cold 
  118.    - Added Initial Support for DSP Plugins 
  119.    - Fixed Bug: List Boxes in the Component No Longer Functional After Configuring a Plugin 
  120.    - Added Support for More Commands: IPC_RESTARTWINAMP, IPC_GETMBURL 
  121.    - Automatically Adds Winamp 2 Plugins Directory to the Search List
  122.  
  123. Version 0.3 - 11/19/2001
  124.  
  125.    - Added Support for More Commands: IPC_SETVOLUME, IPC_SETSKIN, IPC_GETSKIN, WINAMP_OPTIONS_PLEDIT, WINAMP_VOLUMEUP, WINAMP_VOLUMEDOWN, WINAMP_FFWD5S, WINAMP_REW5S, WINAMP_BUTTON1_SHIFT, WINAMP_BUTTON2_SHIFT, WINAMP_BUTTON5_SHIFT, WINAMP_BUTTON2_CTRL 
  126.  
  127. Version 0.2 - 11/8/2001
  128.  
  129.    - Fixed Bug: External Programs Could Not Find Winamp Window 
  130.  
  131. Version 0.1 - 11/8/2001
  132.  
  133.    - Initial Release 
  134.    - Support for gen_*.dll Plugins 
  135.    - Support for Initial Command Subset 
  136.